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Introduction 


There are different ways you can set up your cluster environment to run Webform Server, but 
most likely it will depend on the business needs. In a typical production environment, the 
topology is divided in two large sections: Front End and Back End. 


Front End refers to the segment in the topology where your Application lives plus all the 
essentials that are needed to have this section of the topology up and running like IBM HTTP 
Server (IHS), Load Balancer, Deployment Manager if a cluster environment exists for this part 
of the topology, etc. 

Back End refers to the section where the Webform Server lives plus all the additional 
components needed to have this section of the topology up and running, like IBM HTTP Server, 
Load Balancer, Deployment Manager, Log Server, SharedFileCache, database, etc. 


A typical production environment could be set up as shown in the next diagram: 
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Before you begin 


Prior to installing the Webform Server Translator to a managed node there are 
preparation steps that need to be completed. This guide assumes the use of WebSphere 
Application Server Deployment Manager 8.0.0.4 IBM HTTP Server 8.0.0.4, DB2 v9.7 
and IBM Forms Server 8.0. 


Part Numbers 
CZM90ML - IBM Installation Manager for Windows x86 


CZM9KML - IBM WebSphere Application Server Network Deployment V8.0 (1 of 4) 
CZM9LML - IBM WebSphere Application Server Network Deployment V8.0 (2 of 4) 
CZM9MML - IBM WebSphere Application Server Network Deployment V8.0 (3 of 4) 
CZVG4ML - IBM WebSphere Application Server Network Deployment V8.0 (4 of 4) 


The following four parts make up the image for IBM WebSphere Application Server v8.0 
Supplements Multiplatform Multilingual and also contains IBM HTTP Server v8.0 and 
Plug-ins v8.0 


CZM91ML.zip 
CZM94ML.zip 
CZM9SML.zip 
CZXR9OML.zip 


8.0.0.4: WebSphere Application Server v8.0 Fix Pack 4 found at the following link. 
http://www-01.ibm.com/support/docview.wss?uid=swg24033190 


Including: —8.0.0- WAS-WAS-FP000004-part1.zip 
8.0.0-WAS-WAS-FP000004-part2.zip 
8.0.0-WS-WASSupplements-FP0000004-part1.zip 
8.0.0-WS-WASSupplements-FP0000004-part2.zip 
8.0.0-WS-WCT-FP0000004.zip 


Items not covered 


- Installing the IBM Installation Manager (CZM90ML for Windows x86) 
- Installing DB2 

- Configuring the cluster with WebSphere Process Server 

- Creating multiple clusters in a single cell 


WIKI Information Center: 
http://www-10.lotus.com/Idd/lfwiki.nsf 


**NOTE: To perform the tasks described in this document, you need basic IBM Forms Server 
and WebSphere Application Server knowledge and administration skills. 


Install Manager Defining Repositories 
This document assumes that you have the IBM Installation Manager installed. 


1. Unzip the four part numbers for IBM WebSphere Deployment Manager (CZM9KML, 
CZM9LML, CZM9MML, CZVG4ML) into one directory. 
For example: <Media Root>\WAS\ 


2. Unzip the four part number for IBM HttpServer (CZM91ML, CZM94ML, 
CZM9S5ML, CZXR9ML) into one directory. 
For example: <Media Root>\IHS 


3. Unzip the Fixpack 8.0.0.4 fixes (8.0.0-WS-WAS-FP0000004-part1.zip, 8.0.0-WS- 
WAS-FP0000004-part2.zip, 8.0.0-WS-WASSupplements-FP0000004-part1 .zip, 
8.0.0-WS-W ASSupplements-FP0000004-part2.zip, 8.0.0-WS-WCT-FP0000004.zip) 
into three directories. 

For example: <Media Root>\8.0.0-WS-WAS-FP0000004 
<Media Root>\8.0.0-WS-W ASSupplements-FP0000004 
<Media Root>\8.0.0-WS-WCT-FP0000004 


NOTE: The CD numbers may vary between operating systems. The CD title is WebSphere 
Application Server Network Deployment for Windows X86. 


4. Open the Installation Manager and navigate to File > Preferences > Repositories 


5. Add the repositories for the IBM Websphere Deployment Manager, IBM Http Server, 
and the IHS Plug-ins for example: 


<Media Root>\WAS\ repository.config 

<Media Root>\IHS\repository.config 

<Media Root>\8.0.0-WS-WAS-FP0000004\ repository.config 

<Media Root>\8.0.0-WS-WASSupplements-FP0000004\ repository.config 
<Media Root>\8.0.0-WS-WCT-FP0000004\ repository.config 


6. Click OK and save your changes 


NOTE: The CD numbers may vary between operating systems. The CD title is WebSphere 
Application Server Network Deployment for Windows X86. 


Installing WebSphere Application Server Deployment 
Manager, IBM HTTP Server, and 8.0.0.4 updates 


1. Open the IBM Installation Manager Start > All Programs > IBM Installation Manger 
> IBM Installation Manger. Once the dialog appears click Install. 
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2. Select all packages for installation; Application Client for IBM WebSphere 
Application Server, IBM HTTP Server for WebSphere Application Server, IBM 
WebSphere Application Network Deployment, Pluggable Application Client for IBM 
WebSphere Application Server, Web Server Plug-ins for IBM WebSphere 
Application Server, WebSphere Customization Toolbox. 
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3. Accept the licensing agreement and click Next. 
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4. Select the install location for the shared resources directory. Here we kept the default 
location. Click Next. 
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5. Define the installation directory for the WebSphere Application Client for 
WebSphere Application Server. Here we left the default location. Click Next. 
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6. Select the language and click Next. 
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7. Select the features to install. Here you see the default screen. Click Next. 


@ 16M Installation Manager |. {0} Ea 


Install Packages 


Select the Features to install, 


— - — —_——————_... a 
Install Licenses Location | Features  ) Summary 


Features | 
#2] 0) Application Client for 16M WebSphere Application Server 8.0.0.4 
i (0 16M HTTP Server For WebSphere Application Server 8.0.04 
+ (U) IBM WebSphere Application Server Network Deployment 8.0.0.4 
+ Pluggable Application Client for IBM WebSphere Application Server 8.0.0.4 
I ie Web Server Plug-ins for IBM WebSphere Application Si 6.0.0.4 
+ (L) WebSphere Customization Toolbox 8.0.0.4 


0 Show dependencies 
%g- Selected by Installation Manager because of dependencies 


Restore Default 


Details 


Application Client for IBM WebSphere Application Server 8.0.0.4 


Application Client for IBM WebSphere Application Server provides resources and clients to aid development of client applications For use with 
WebSphere Application Server. The Application Client provides a runtime framework For client applications either to run on the Application 
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8. Define the configurations for the packages. Here we left the defaults; however, for a 
production environment you will need to define the host name and port configuration. 


@ 16M Installation Manager | |O x} 
Install Packages 
Fill in the configurations for the packages. 
Install Licenses Location | Features > Summary 


®4, IBM HTTP Server V8.0 Configuration for IBM HTTP Server for WebSphere Application Server 8.0.0.4 
8 o IBM HTTP Server for WebSpher) Web Server Configuration 

& Web Server Configuration = 
=I “a Pluggable Application Client For IBV Specify a port number for IBM HTTP Server to communicate. The default port is 80. IF the defau 


=) (1) Pluggable Application Client for use, then change to another port that is available. Running IBM HTTP Server without root or 4d 
Host name and port configt privileges might restrict use of ports below 1024, 
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=) %, Application Client for IBM WebSphe HTTP port: | 80 


= (9 Application Client for IBM Webs 
Host name and port configt 


Choose whether to use a Windows service to run IBM HTTP Server, If a service is created, also 
type to have the Windows service start manually or automatically when rebooting the system, 


¥ Run IBM HTTP Server as a Windows Service. 


@ Log on as a local system account 


© Log on as a specified user account 


User name: [celine 
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9. Define the host name and bootstrap port number. In this screen, we are leaving the 
defaults. You will want to define the host name of your server. Click Next. 
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10. Define the location of Sun Java Runtime Environment. The installation requires a 
minimum of JRE 1.6. Click Next. 
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11. Fill in the configurations for the packages for the Application Client. For this 
installation we selected the defaults; however, for a production server you will want 
to define the host name and bootstrap port number for your server. 
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12. Review the install summary and click Install. 
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13. There are warnings in the install logs because a profile for the WebSphere 
Application Server and IBM HTTP Server Web Server are not defined. Click Finish 
to start the Profile Management Tool to Create a profile. 
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‘onfiguration errors were detected during the installation. You should view the log file(s) under C:\Program 
iles\IBM\HTTPServer\logs\postinstall directory to investigate the severity of the errors. 


The following packages were installed: Which program do you want to start? 
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Creating a Profile 


1. From the WebSphere Customization Tool box click Create. 
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2. Highlight Cell (deployment manager and a federated application server) and click Next. 
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Select a specific type of environment to create, 
Environments: 
© WebSphere Application Server 
Cell (deployment manager and a federated application server) 
Management 
Application server 
Custom profile 
Secure proxy (configuration-only) 


~ Description 


4 cell environment creates two profiles; & management profile with » deployment manager and an application server profile, The application server is Federated to 
the cell of the deployment manager. 
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3. Select “Typical profile creation” and click Next. 


€& Profile Management Tool 8.0 


Profile Creation Options 


Choose the profile creation process that meets your needs. Pick the Typical option to allow the Profile Management Tool to assign a set of default configuration s 
values to the profile, Pick the Advanced option to specify your own configuration values for the profile, 


fy 


Create a cel that uses defau® configuration settings for the deployment manager and the application server. The Profile Management Tool assigns unique 
names to the profiles, nodes, host, and cell. The tool also assigns unique port values. The administrative console and the default application will be installed, 
but the Sample applications will not be installed, You can optionally select whether to enable administrative security. The tool might create a system service to 
run the deployment manager depending on the operating system of your machine and the privileges assigned to your user account, 


Note: Default personal certificates expire in one year. Select Advanced profile creation to create a personal certificate with a afferent expiration. 


© Advanced profile creation 


Create a cell using default configuration settings or specify your own values for settings such as the location of the profile and names of the profiles, nodes, 
host, end cell. You can assign your own port values. You can optionally choose whether to deploy the administrative console, the defauit application, and 
Sample applications, and create a Web server definition. You might have the option to run the deployment manager as a system service depending on the 
operating system of your machine and the privileges assigned to your user account. 


bs 


<Back Next > finish | Cancel | 


11 


4. Add the username and password for the administrative security and click Next. 
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5. Review the profile creation summary and click Create. 
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Oren 


Applet rerver aneroraent te crewne: Cel (dettoywent memeger and « tacetated epkeaton perver) 
Locaten: <)Prog ain Piece te blet anal Agger ver grating 
Ded A remaree SmI 


Profie cype: Cat ceriogrmert iareger 
Pole raren Drage 
itd ies fle te elt Tyee 


Coreen Drew Ceti 
Mode name: Deed Oceana 
Hear Cana Eat Paredlige cca 


Depry te eceerwet erve corocte [recarerenchet | true 
Dectoy the Geta ® ancication. True 


Dante eter tree sme ty heme nid) The 
Seoreesy cove che Don: RD 

Petre etratwe conthe emcee pest, 42 

Ne pet, 

SOUP rowmetze pert: SITY 


Fe cectcneere ream Ot ooo en: Le 


Crnden 9 Web sevem dat eanien Pave 2) 
<i oe }_<va J 

4 WebSphere Customization Toolbox 8.0 [jor x! 

Eile Window Help 

1) | @ Profile Management Tool € Welcome 

© Profiles 25] 


| Profilensme | Environment 


Cell application server C:\Program Files\IBM\wWebSphere\App. .. 
Cel deployment manager C:\Program Files\IBM\ WwebSpherel App. .. 


6. When the profile creation completes click the “Launch the First steps console” and click 


Finish. 


4 WebSphere Application Server - 


First steps - 


WebSphere Application Server 


Dmg 


First steps 


software products. 


Exit 


7. To ensure the installation was successful you should see the confirmation on the command 
line generated. 


Installation verification 
Confirm that your server is installed and that it can start properly. 


Start the deployment manager 
Start the deployment manager and its applications. 


Administrative console 


Install and administer applications. 


WebSphere Customization Toolbox 

Launch this toolbox to access the Profile Management Tool and work with profiles, or to 
access the Migration Management Tool and migrate WebSphere Application Ser er 6.0,6.1 
or 70 profiles to versiond 0. 


Information center for WebSphere Application Server 
Learn more about Web Sphere Application Server and explore sarnple applications. 


IBM Education Assistant for WebSphere software 
Access multimedia content for WebSphere Application Server version 8.0 and other IBM 


s output 


10/1/12 12:00:32:141 POT) 0000000d wtp 
“ 0/1/12 12:00:32:141 PDT] 0000000d wip 
10/1/12 12:00:32:156 PDT] 0000000d wip 
; 0/1/12 12:00:32:156 PDT) O000000d wip 
10/1/12 12:00:32:156 PDT] G000000d wtp 
(10/1/12 1 2:00:32:156 PDT) C000000d wtp 
u 0/1/42 12:00:32:1 56 PDT) 00000000 wtp 
10/4/12 12:00;32:156 PDT] 0000000d wtp 
10/1412 12:00;32:188 PDT] 0000000d wip 
10/1/12 12:00:32:188 PDT] 000G000d wip 
10/1/12 12:00:32:188 PDT] O00000d wip 
10/1/12 12:00:32:188 PDT] 0000000d wip 
10/1/12 12:00:32:1 88 POT) 00000000 wtp 
10/1/12 12:00:32:1 88 PDT] GO00000d wip 
10/1412 12:00;32:203 PDT] 0000000d wtp 
10/1/12 12:00:32:656 POT] 0O00000d wip 
Donn 2 12:01:39:643 PDT] 0000000d wip 
eh 2 12:01:39:690 PDT] 0000000d wip 


, pois 212:01:47: stats PDT] 00000004 FrdcProvider ¥V¥ com.ibm.ws.fdc.tmpl.FidcProvider logincident FFDC1 0031: FFDC Incident emitted on CAProgram Filesil 


LO0401, 65 errors 
Loo7ol 
om 


L 


Installation verification 


he installation verification "Tool eriacetar mccmtind 
he installation verification is complete 


W org.eclipse.jstj2ee.commonarchivecore intemal. strategy. LoadStrategylmpl createFile FileNotF oundExceptio 
W org.eclipse jstj2ee commonarchivecore intemal, strategy.LoadStrategylmpl createFile FileNotF oundExc eptio| 
W org.eclipse.jstj2ee commonarchivecore internal, strategy, LoadStrateayimpl createFile FileNotF oundExceptio: 
W org.eclipse.jst/2ee.commonarchivecore .intermal.strategy.LoadStrategylmnp! createFile FileNotF oundExceptio 
W org.eclipse.jstj/2ee.commonarchivecore intemal. strategy.LoadStrategylmp! createFile FileNotF oundExceptio 
W org.eclipse.jstj/2ee.commonarchivecore.intemal.strategy.LoadStrategyimpl createF ile FileNotf oundExceptia 
Wi org.eclipse.jstij2ee.commonarchivecore.intemal.strategy.LoadStrategylmol createF ile FileNotf oundExceptio) 
W org. eclipse. jstj2ee. commonarchivecore intemal.strategy.LoadStrategylmpl createFile FileNotF oundExceptio 
W org.eclipse, jstj2ee. commonarchivecore intemal,strategy.LoadStrategyimpl createFile File NotF oundExceptio) 
W org.eclipse.jstj2ee.cormmonarchivecore internal, strategy.LoadStrateaylmp!| createFile FileNotF oundExceptio 
W org.eclipse.jst}2ee commonarchivecore intemal.strategy. LoadStrategylmp! createFile FileNolF oundExceptio 
Wi org.eclipse.jstj/2ee.commonarchivecore.intamal.strategy. LoadStrategylmp! createFile FileNotF oundExceptio) 
W org.eclipse.jstj2ee.commonarchivecore intemal.strategy.LoadStrategyimpl createF ile FileNotf oundExceptio: 
W¥ org.eclipse.jstj2ee.commonarchivecore.intemal.strategy.LoadStrategylmpl createFile FileNotf oundExceptio 
WV org.eclipse.jstj2ee.commonarchivecore.intemal.strategy.LoadStrategylmpl createFile FileNotF oundExc eptio| 
W org.eclipse, jstj2ee. commonarchivecore intemal, strategy. LoadStrategylmpl createFile FileNotF oundExc eptio| 
WV org.eclipse.jstj2ee. commonarchivecore internal, strateay.LoadStrategyimpl createFile FileNotF oundExceptio: 
W org.eclipse jstj/2ee. commonarchivecore intemal. strategy. LoadStrategylmp! createFile FileNolF oundExceptio 


BmiWvebSphereppServerprofile siDmg 0 1VlogsidmagnsystemOut.log file 
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Configuring the Web Server 


Start the Web Server Plug-ins Configuration Tool. Start > All Programs > IBM 
WebSphere > WebSphere Customization Tool > Tools > Web Server Plug-in 
Configuration Tool. 


2. Highlight the Web Server Plug-in and click Create. 


4 WebSphere Customization Toolbox 8.0 i=l Es 
Elle Window Help 


F2 |@ web Server Plug-ins Configuration Tool €> Welcome 


© web Server Plug-in Runtime Locations | 


Cif roar arm Féesi IBM Webs 


© web Server Plug-in Configurations | @) web Server Plug-in Response File 


3. Select the Server to configure. In this case we are configuring the IBM HTTP Server. 


Web Server Plug-ins Configuration Tool 8.0 |. {Oa x} 


Web Server Selection 6 


Select the Web server to configure. Verify that the Web server you select to configure has been installed. 


} 

¥2.2 

© Lotus Domino Web Server VS 

Sun Java System Web Server V6.1 or Sun Java System Web Server V7.0 
( [Microsoft Internet Information Services V7 

¢~ Microsoft Internet Information Services ¥6 
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4. Select the existing IBM HTTP server httpd.conf file. 


} Web Server Plug-ins Configuration Tool 8.0 l=) ES 


Web Server Configuration File Selection 3 6 


Select the Web server configuration file and identify the Web server port to configure the Web server definition, 


Select the existing IBM HTTP Server httpd.conf File: 


[e:\Program Files\IBM\HTTPServertconfihttpd conf Browse... | 


Specify the Web server port: 


feo 


5. Create a user ID for the IBM HTTP Server Administration server authentication. 


4 Web Server Plug-ins Configuration Tool 8.0 i=l Ez 


Setup IBM HTTP Server Administration Server 3 6 


Optionally configure an sdministrative server to administer the Web server. You can manage the Web server from 4 WebSphere Application Server 
administrative console by using the IBM HTTP Server administrative server to control the communication between them. 


Setup IBM HTTP Server Administration Server 


Specify @ port number for IBM HTTP Server administation server to communicate. The defauk port is 8008, If the defauk port is already in use, then change 
to another port that ts available, Running IBM HTTP Server administation server without root or Administrative privileges might restrict use of ports below 
1024, 


HTTP Administration Port: 
8008 


Optionally create 4 user ID and password to authenticate to the IBM HTTP Server Adrninistation Server from the WebSphere Application Server 
administrative console. The user ID and password is encrypted and stored in the conf/admin.passwd file. You can create additional user IDs after the 
configuration by using the htpasswd utility. 


I Create a user ID for IBM HTTP Server Administration Server authentication 


User ID; | wasadmin 
Password: | sescecesees 
Canfirm password: | eeesecceses| 


< Back Finish Cancel | 


15 


6. When the dialog Non-Administrative user configuration limitation appears, click Next. 


4 Web Server Plug-ins Configuration Tool 8.0 -/O1 x! 


Setup IBM HTTP Server Administration Server 3 =) 


Non-Administrative user configuration limitation 


The user account running the configuration does not have Administrator privileges, therefore a Windows serivce cannot be created ro run the IBM HTTP Server 
Administration Server. Without a Windows service to run the IBM HTTP Server Administration Server, the administration server cannot start or stop the web 
server from a WebSphere Application Server administrative console, 


When both the IBM HTTP Server and WebSphere Appication Server are installed to the same machine, an IBM HTTP Server Administration Server Is mot 
required to propogate the web server plug-ins configuration file (plugin-cfg. xml) from the application server to the web server. 


} Web Server Plug-ins Configuration Tool 8.0 
Web Server Definition Name 3 a, 


Use a Web server definition to manage 4 Web server through the WebSphere Application Server administrative console or the wsadmin tool, The definition name 
must be unique because this name is used to identify this Web server in the administrative console, 


Specify a unique Web server defintion name: 
| webserver 
The Web server definition name must not be empty and it must not contain the Following special characters or space: 


VT tpt? | cre "(> FF {} 
Note: 6 period(.) i not valid if it is the first character, 
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8. Define remote or local host. For a production environment, this should be on a separate 
server and therefore you would select he remote configuration. Click Next. 


@ Web Server Plug-ins Configuration Tool 8.0 


Configuration Scenario Selection 


Configure the Web server plug-ins to the computer where the Web server exists. When the Web server and application server are not on the same computer, 
choose the remote configuration scenario, When both Web server and application server are on the same computer, choose the local configuration scenario, In 
the local scenario, the Web server definition you create in this wizard Is defined automatically in the application server, 


~ Configuration scenario 
@ (Remote) Host mame or IP address of the application server 


[_— oHe"#BG;,__ . um — 


© (Local) Installation location of WebSphere Application Server 
Jc ‘Program Files \IBM\\WebSphere\AppServer 


Browse... 


For the remote configuration scenario, the host name must be accessible on the network through one of the Following address Formats: 


Fully qualified domain name system (DNS) host name 
The default short DNS host name 
Numeric IP address 


9. Define the profile where the web server will be configured and click Next. 


& Web Server Plug-ins Configuration Tool 8.0 | |g x! 
WebSphere Application Server Profile Selection 3 6 


Select the WebSphere Application Server profile bo configure with the current Web server plug-in and create the Web server definition. 


Available Profiles: 
Jomoro1 ¥ ] 
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10. Review the summary and click Configure. 


@ Web Server Plug-ins Configuration Tool 8.0 


Plug-in Configuration Summary 


Pilz) Es 


Review the information below for accuracy. Click Configure to begin configuring the Web server, Web server plug-ins, and application server profile, 
Web server to configure: 
IBM HTTP Server ¥8 


Web server definition: 
webserver! 


WebSphere Application Server profile information; 
dmgtl1 


Plug-in corifiguration file: 


C:\Program Files \IBM\WebSphere\Plugins \config\webserver! \plugin-cfg. xml 


irish Cancel | 
11. When the installation completes, click Finish. 
4 WebSphere Customization Toolbox 8.0 BEE 
File Window Help 
BI {s) Web Server Plug-ins Configuration Tool Welcome 
‘ . . a 

© Web Server Plug-in Runtime Locations. D] 

ae (ae ae Add... 

WAS THS Plugin | C:\Program Files IBMiWebSphere|Plugins 


= 


© Web Server Plug-in Configurations © Web Server Plug-in Response File | 


iol 
Web Server Definition Web Server Type Plug-in Configuration File Create.., | 
IBM HTTP Server C:\Program Files\IBM\\WebSphere\Plugins\config\webserver1 plugin. .. 


Delete | 


webserver! 
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} Web Server Plug-ins Configuration Tool 8.0 


Plug-in Configuration Result = 


Success: ~ 
The configuration has been completed successfully. 


The stand-alone application server is configured with a Web server definition, You may start up your Web sever and application server to test your 
configuration, 


Web server type configured: 
IBM HTTP Server VB 


Web server definition: 
webserver! 


Plug-in configuration file: 
C:\Program Files IBM\ WebSphere Plugins \config\webserver1 \plugin-cfg. xml 


12. From the command prompt, navigate to C:\IBM\WebSphere\Plugins\bin. Look for a script 


file with the name you gave the HTTP server in the previous step. The syntax of the file will 
be as follows: 


configure <HTTPServer name>.bat (ie. configurewebserver] .bat) 
13. Copy the bat file to the WAS server location C:\IBM\WebSphere\AppServer\bin 


14. From C:\IBM\WebSphere\AppServer\bin run the configurewebserver1 .bat file to 
automatically configure the HTTPServer with the WebSphere Application 
Deployment Manager (DMGR). 


15. Log into the WebSphere Application Server administration console and navigate to Servers > 
Server Types > Web servers to verify the webserver! is configured correctly. 


Web servers 


Use this page to view a list of the installed web servers, 


# Preferences 


Generate Plug-in Propagate Plug-in il New. | Delete Templates... Start | Stop | Terminate 


eat? 


Select Name 3_ Web server Type O_ Node 3_ Host Name O_ Version S_ | Status @_ 


You can administer the following resources: 


Vv webseryvert IBM HTTP Server l2vm11iNode01 l2ym11,PureEdge.com ND 8.0.0.4 => 


Total 1 
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16. Click on webserver and continue navigating to Plug-in properties > Request routing and 
confirm the load balancing option is set to RoundRobin 


Web servers 


Web servers > webserveri > Plug-in properties > Request routing 
Use this page to configure request routing properties for a Web server plug-in. These properties apply to all 
requests the Web server routes to application servers. 


Configuration 


Request routin: 


Load balancing option 
Round Robin | ¥ 
* Retry interval 
60 =all seconds 
Maximum size of request content 


@ No Limit 
O Set Limit 


# Maximum buffer size used when reading the HTTP request content 
64 | KBytes 


Remove special headers 
al Clone separator change 


[Apply | | ok | | Reset | | Cancel 


17. Save the changes. 
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Installing Lotus Forms Webform Server 8.0 
The installation of Webform Server will be completed on the federated Node. Ensure you 


do not install the Webform Server on the DMGR. This document assumes the 


SharedFileCache is installed on the save server. In a production environment, you should 
consider putting the SharedFileCache on a separate server. 


1. Double click the exe file to start the IBM Forms Server install 


2. Select the language and click OK 


IBM Forms Server 8.0 


Licensed Materials - Property of IBM. L-RSHR-SRBQLS (C) Copyright IBM Corporation and its 
Scensors 1994, 2012. All Rights Reserved. IBM and the [8M logo are trademarks of IBM Corporation in 
the United States, other countries, or both. Built on Eclipse is a trademark of Eclipse Foundation, Inc. 
Other company, product or service names may be trademarks or service marks of others. This 
Program is licensed under the terms of the Scense agreement accompanying the Program. This 


license agreement may be either located in a Program directory folder or library identified as “License” 


or “Non_IBM_License™, if applicable, or provided as a printed license agreement. Please read the 
agreement carefully before using the Program. By using the Program you agree to these terms. 


3. 


s 
QO 
5 


Preparation 


Orn 


ie) 
) 


BUILT ON 


PS 
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4. Accept the licensing agreement and click Next 


4 IBM Forms Server 


9 Preparation 
© Decisions 
@ Configuration 

© Pre-Installation Suramary 
Q Installing... 

QO Install Complete 


Please read the Following license agreement carefully, 


International Program License Agreement 


Part 1 - General Terms 


BY DOWNLOADING, INSTALLING, COPYING, ACCESSING, 
CLICKING ON AN "ACCEPT" BUTTON, OR OTHERWISE USING 
THE PROGRAM, LICENSEE AGREES TO THE TERMS OF THIS 
AGREEMENT. IF YOU ARE ACCEPTING THESE TERMS ON 
BEHALF OF LICENSEE, YOU REPRESENT AND WARRANT THAT 
vole HAVE FULL AUTHORITY TO BIND LICENSEE TO THESE 
TERMS. IF YOU DO NOT AGREE TO THESE TERMS, 


* DO NOT DOWNLOAD, INSTALL, COPY, ACCESS, CLICK ON | F 


© Ido not accept the terms in the license agreement. 


Ned 


5. Accept the default installation directory and select Next 


42 IBM Forms Server 


® Preparation 
© Detisions 
@) Configuration 
© Pre-Installation Summary 
© Installing... 
Q Install Complete 


Create an installation directory 


[C\Program FilesWBM\Forms Serveri8.0 
Browse | 


6. Select Webform Server Translator and click Next 


Wi IBM Forms Server 


@ Preparation 

& Decisions 

© Configuration 

O Pre-Installation Summary 
© Installing... 


Q@ Install Complete 


IV Forms Application Components 


Installs the following components: Forms API, Webform Server framewol 
Forms Services Platform and the Forms View Portlet. Also installs the 
Webform Server sample servlet and sample forms. 

Note: In a production environment, you should install these \gmponents 
on a different server than Webform Server Translator. For development 
use, you can install the components on the same server as Webform 
Server Translator. 


I¥ Webform Server Translator 


Installs Webform Server components that are required to translate IBM 
Forms into HTML for direct browser rendering. 

[ICM Integrator 
Installs the required components to integrate IBM Forms with Case 


Manager. Pre-requisite Case Manager components must be installed 
prior to installation of the ICM Integrator. 


— FileNet P8 Integrator 


Installs the required Server components to integrate Forms with FileNet + 
4| | rf 


Cancel 


7. Select Deploy Forms API and to Deploy Webform Server Translator to WebSphere 
Application Server and click Next 


WZ IBM Forms Server lel Eg 


@ Preparation 
@ Decisions 
© Configuration 

Q Pre-installation Surnmary 
© Installing.. 

@ Install Complete 


¥ Deploy Forms API 


Makes the Forms API available to WebSphere Application Server, 
WebSphere Process Server, or WebSphere Portal for use with IBM Forms 
applications. 

Ifyou do not select this option, you can manually deploy the API after 
installation is complete. See "Configuring WebSphere Application Server 
to use IBM Forms API" for more information. 

Ifyou selected Forms Application Components then the Webform Server 
sample servlet will also be deployed. 


¥ Deploy Webform Server Translator to WebSphere Application Server 
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8. Select use default location for the Shared File Cache and click Next. 


‘<Q IBM Forms Server 


@ Preparation Shared File Cache 
@ Decisions 

® Configuration 

(®) Pre-Installation Summary 
© installing... 

@ install Complete 


¥ Use default location 


@ Preparation Enter the location of WebSphere Application Server. 
@ Decisions 
@ Configuration 
@ Pre-Installation Summary bach di ANd AAs 
O Installing... 

© Install Complete 


Directory Name: 
CAProgram FilesiBMiwWebSphere\appServer_ 
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10. By default the data for the node and cell will auto-populate. Verify the auto-populated 
data is correct. Scroll down and define the user name and password for the 
WebSphere Application Server and click Next. 


Vl IBM Forms Server 


@ Preparation 
@ Decisions 
@ Configuration 
@) Pre-Installation Summary 
@ Installing... 


Q Install Complete 


API deploy to WebSphere Application Server Details: = 
Profile 


Cell (must already exist) 
[lave 1Cell01 

Node (must already exist) 
I2vm11Node01 
Server Name (must already exist 


[servert 


Webform Server Sample Serviet Details: 
Application Name 

[WebformSampleapp 

Application Context 

/Samples 


Enter Credentials 


Cancel Previous Net | 


11. Once the installation completes, start the Translator from the WebSphere Application 
Server Deployment Manager administration console 
Servers > Server Types > WebSphere application servers 
Test the installation by accessing the toolbelt URL. 


http://<server_name>:8085/translator/Translate? Action=toolbelt 
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Webform Server 


Vebform Server allows you to use a Web browser to view and complete XFDL forms. 
The toolbar buttons provide the following functionality: 


Opens any XFDL form that is available on the local computer or network. 
Shortcut key: Alt + O 


w 


fal Saves the current form to the local computer as an XFDL file. 
Shortcut key: Alt +S 


2 Prints the form to the local printer. 
Shortcut key: Alt + P 


5] Refreshes the form, which updates all of the computes in the form. 
Shortcut key: Alt +R 


1] Toggles the accessibility mode. YWhen this mode is active, you will see an enhanced focus indicator on 
any item that has the focus. As well, the form will provide additional information to active screen readers 


Creating TranslatorServer Cluster 


1. From the deployment manager administration console, navigate to Servers > Clusters 
> WebSphere application server clusters and select New 


| Sere. FY a | | 
Blt purer ag aes perso cule. 
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application eereers JF oe of the rember peers Pode, requert will beg rated Yo other rarmbarr of the 
he err cluster, Lag rene about tip task ina guided activites Goguidad ecteiy oreadas = lhtoftaek steps and 
B] fairer Teer mera gareanel erfocetion eb out Hem topic: 
EL Chicane B] Peefara recor 
Be le see or ee ere 
ree rsa ichabie ta nl Lemp | Pipplarert jn in mis dinbe ny i 
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2. Key in the name of the New cluster (WFS_ Cluster) and click Next 


Create a new cluster 


Create a new cluster 


peweeeee + Cluster name 
~Feate TiSt WFS_Cluster 


r roember 


Prefer local, Specifies whether enterprise bean requests will be routed 


to the node on which the client resides when possible, 


al Configure HTTP session memory-to-memory replication 


3. Select the radio button Create the member by converting an existing application server 
and select the secondary node TranslatorServer 


Create a new cluster 


The first cluster member determines the server settings for the cluster members. A server configuration template 
is created frorn the first member and stored as part of the cluster data, Additional cluster members are copied 


from this template. 


+ Member name 
f ranslatorServer 


Select node 
[i2emniinedeoi(nD 8.0.0.4) | 


* Weight 


2 (0..100) 


TT Generate unique HTTP ports 


Select how the server resources are promoted in the cluster. 
Cluster _y_ 


Select basis for first cluster member: 
© Create the member using an application server template. 
[aefaute =| 
© Create the member using an existing application server as a template, 


| l2ym1iCell01/l2vmiiNodeDi(ND 8.0.0.4)/TranslatorServer =| 


@ Create the member by converting an existing application server. 


[i2vmn11cello1/l2vmiiNodeo1(ND 8.0.0.4)/TranslatorServer wl 


6 None, Create an empty cluster. 


_Previous | Next] Cancel | 


4. Type in the name of the next cluster member (TranslatorServer1), check Generate unique 
HTTP ports and click Add Member 
5. Select the Node 


Zt 


Create a new cluster 


Enter information about this new cluster member, and click Add Member to add this cluster member to the 
member list. A server configuration ternplate is created from the first member, and stored as part of the cluster 
data, Additional cluster members are copied from this ternplate. 


* Member name 
TranslatorServert| 


Select node 


Ji2vmiiNodeoi(ND 8.0.0.4) =) 


* Weight 
[2 (0.,100) 


M Generate unique HTTP ports 


Add Member 


Use the Edit function to modify the properties of a cluster member in this list. Use the Delete function to rernove a 
cluster member from this list. You are not allowed to edit or remove the first cluster member. 


Select Member name Nodes Version 


TranslatorServer l2um41Node01 ND 8.0.0.4 
Total 1 


6. Create a third clustered member called TranslatorServer2 and clicking Add Member, 
click Next 


Create a new cluster 


Enter information about this new cluster member, and click Add Member to add this cluster member to the 
member list. A server configuration template is created from the first member, and stored as part of the cluster 
data. Additional cluster members are copied from this template. 


+ Member name 


ie Select node 

ai Sharan ary Ji2vmiinededi(ND 8.0.0.4) =) 
+ Weight 

2 (0..100) 


Vv Generate unique HTTP ports 


Use the Edit function to modify the properties of a cluster member in this list. Use the Delete function to remove a 
cluster member from this list. You are not allowed to edit or remove the first cluster member. 


ia 


Member name Nodes Version 


TranslatorServer l2ymiiNode01 ND 8.0.0.4 


TranslatorServer1 | l2ymiiNode01 | ND 8.0.0.4 


TranslatorServer2 | I2ymiiNode01 | ND 8.0.0.4 


Total 3 


7. Review the Summary and Click Finish 
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Surmmiary of actions: 


Options 


Values 


Cluster Name 


WFS_Cluster 


Core Group 


DefaultCoreGroup 


replication 


Server name 


Node group DefaultNodeGroup 
Prefer local true 
Configure HTTP session memory-to-memory fale 


TranslatorServer 


Node 


I2vm11Node01(ND 8,0,0,4) 


Weight 


2 


Clone Template 


I2um11CellO1/l2vm11iNode01(ND 3,0,0,4)/TranslatorServer 


Clone Basis 


Create the member by converting an existing application 


Server name 


server, 
Select how the server resources are promoted in the 

cluster 
cluster, 
Generate unique HTTP ports false 


TranslatorServer1 


Node 


I2vrniiNodeO1(ND 8.0.0.4) 


Weight 


2 


Clone Template 


Version 8 member template 


Server name 


Generate unique HTTP ports 


true 


TranslatorServer2 


Node 


I2urn11NodeO1(ND 8.0.0.4) 


Weight 


2 


Clone Template 


Version 8 member template 


Generate unique HTTP ports 


true 


8. Save all the Clustered member changes 


9. Start the WFS_ Cluster: Servers > Server Types > WebShere application server Check 
the checkbox beside the Translators and click the Start button. 


Verifying Host aliases for the new clustered members 
1. From the DMGR administration console, navigate to Environment > Virtual Hosts > 


default_host 


integrated Sotutioas Conscie Welcome wasadman Help | Le guut 


| Wiewy; | All tasks 


Yrabomne 


Guided achvites 
servers 
 Appliostions 

Bi resources 


cantiguratian 
Websobere Vanebies 
Shared Lerane: 
Reptcaton domens 
UPI Groups 

Bktenng 
i System odminstraven 


Ros Web server plugin 


Vietual Hosts 


Use this page to create = virtual hast with a unique cet of Web access porte. Such a 
configuration kets 2 singk Nast machine resemble multiple host machines. Each wirtua host 
hes 2 gical name and 2 fst of one of mare domain mame system (ONS) aliases by which 
itis trown. 


Preferences 
New | Delete | 
L = Tio hea ee a 

Saket, Name & 

Oo actus best 
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2. Select Host Aliases under Additional Properties 


Virtual Hosts 


Virtual Hosts > default_host 


Use this page to create a virtual host with a unique set of Web access ports. Such a 
configuration.ets a single host machine resemble multiple hast machines, Each virtual host 
has a logical name and a list of one or more domain name system (DNS) aliases by which 
it is known. 


Configuration 


General Properties 
* Name 


default_host 
| Apply ‘OK| | Reset | | Cancel 


Additional Properties 


3. Here you should see the Host Aliases using ports 8085, 8086, and 8087. If you do not 
see these three ports then select new and add them. 


Virtual Hosts r= 


¥irtual Hosts > default host > Host Aliases 


Use this page to edit, create, or delete a domain name system (DNS) alias by which the 
virtual host is known, 


Preferences 


Delete | 
(| Ey (| 
Select Host Name © Port > 
el OL 9082 
A 80 
= | 

ey | * 9445 
o (2 5063 
Oo pat 
oO * 
O f * 
oO * 

* 
aE |= 
Total 9 
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4. 


Navigate to Applications > Application Types > WebSphere Enterprise Applications 
> TranslatorApp > Manage Modules and select IBM Webform Server Translator. 
Highlight WFS_Cluster and webserver! and click Apply. 


Enterprise Applications 


5. 


6. 


Enterprise Applications > TranslatorApp > Manage Modules 


Manage Modules 


Specify targets such as application servers or clusters of application servers where you want to install the modules that are contained in your application. 
Modules can be installed on the same application server or dispersed among several application servers, Also, specify the Web servers as targets that 


serve as routers for requests to this application, The plug-in configuration file (plugin-cfg.xml) for each Web server is generated, based on the applications 
that are routed through, 


Clusters and servers: 


sm11CellO1,n¢ smiiNodett 


| Remove Update | Remove File Export File 


“Select Module “URI 


Module Type | Server 


IBM Webform Server Translator $.0.1.94 


translator.war, WEB-INF/web.xml | Web Module 


WebSphere: cell=l2vmi11Cell01,cluster=wWFS_Cluster 


{oK| Cancel 


Navigate to Servers > Server Types > Web servers. Select webserver! and click 
Generate Plug-in 


Click Propagate Plug-in 


Web servers 


Us 
# 


Generate Plug-in fl: 


e this page to view a list of the installed web servers. 


Preferences 


Terminate 


Propagate Plug-in 


|New... |) Delete || Templates... || Start || stop 


ea? 


Se 


You can administer the following resources: 


lect, Name > 


a Web server Type S_ Node S_ Host Name O_ Version _ Status @)_ 


Vv 


webservert IBM HTTP Server I2ym1iNodeO1 


I2vm11,PureEdge.com ND 8,.0,0.4 | > 


Total 1 


oF 


Navigate to System administration > Node agents to verify the status of the node 
agent. You should see a green arrow under the status column. 


If the Clustered members are not already started, navigate to Servers > Server Types 
> Application Servers Check the checkboxes beside each Translator Server and click 


start to start the servers. You will see a green arrow under the status column once the 
servers are started. 


Application servers 


Application servers 


Use this page to view a list of the application servers in your environment and the status of each of these servers. You can also use this page to change the 
status of a specific application server. 


a 


Preferences 


New... || Delete Templstes... Start || Stop|| Restart || Immediatestop || Terminate 
tee 

eles 
Select) Name > Node > Host Name © [version S Cluster Name © Status @© 
You can administer the following resources: 
rc TranslatorServer I2um1i1Nodeo1 I2um1i.PureEdge.com | ND 8.0.0.4 WFS_Cluster > 
oO TranslatorServert I2um1iNode01 l2um11.PureEdge.com ND 8.0.0.4 WFS_Cluster > 
oO TranslatorServer2 I2umiiNode01 l2um11.PureEdge.com ND 8.0.0.4 WFS_Cluster > 

| rc serverl I2umn1iNodeo1 I2um11.PureEdge.com | ND 8.0.0.4 > 

Total 4+ 
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9. Test each of the Translators to ensure each is working successfully. 


a) 


b) 


Open a browser and navigate to: 

<server name>:8085/translator/Translate?Action=toolbelt 

The Welcome to IBM® Lotus® Forms Server - Webform Server page opens. 
Note: This is the only time that you should access the Translator directly from a 
browser. In production use you should access the Translator only by your servlets 


or portlets. 


If the Welcome to IBM IBM Forms Server - Webform Server page does not open, 
refer to the Troubleshooting the installation section of the info center. 


http://publib.boulder.ibm.com/infocenter/forms/v3r5m 1/index.jsp 
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Federating the Second Node with Deployment Manager 


This section assumes you have installed the WebSphere Application Server 8.0.0.4 on 
another server and are ready to create a managed node. 


1. On the secondary server navigate to C:\Program 
Files\IBM\WebSphere\AppServer\profiles\AppSrv01\ bin 
2. Run the addNode command as follows: 
addNode.bat <Name of host profile> <host port> 
addNode.bat DMGR. victoria.ibm.com 8879 


**NOTE: See troubleshooting steps if addNode task fails 
3. Navigate to the DMGR administration panel and review the nodes listed under 
System administration -> Nodes. 


4. Verify the nodeagents are running System administration 


Webform Server Install and Set-up on additional Nodes 


There are often times that a company user base outgrows the current server setup. 
Additional nodes allow for the capacity needed. This section discusses how to add 
additional nodes with additional TranslatorServer members. This section assumes that the 
node3 is installed before completing this section. 


1. Install WebSphere Application Server as a managed node and upgrade as described 
earlier in this guide. 

2. Verify the Deployment manager, node, and nodeagent are running 

3. Start the install of Webform Server on the new node. 

4. Choose NOT to deploy the translator application by deselecting Webform Server 
Translator 


4) IBM Forms Server 


@ Preparation 
@ Decisions 


[ Forms Application Components 
installs the following components: Forms API, Webform Server framework, 
Forms Services Platform, the Forms View Portlet, and the Forms (Widget. 
Also installs the Webform Server sample semtet and sample forms 
Note: In a production environment, you should install these components on 
a different server than Webform Server Translator. For development use, 
you can install the components on the same server as Webform Server 


Deselect this option 


ents that are required to translate IBM 
Forms into HTML for direct browser rendering 

[ FiteNet P8 Integrator 
Installs the required Server components to integrate Forms with FileNet PS 
Application Engine or Workplace XT. Pre-requisite FileNet components 

must be installed prior to installation of the P8 Integrator 


000 


ie 
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**Note: Depending on the environment there may be a few additional steps, for example, 
modifying WebSphere Application Server environment variables, and copying the DB2 
drivers to the new node. This guide does not cover these steps. 


Adding additional Translator Cluster members for 
additional nodes 


1. 
2. 


Access the Deployment Manager 
Navigate to Servers > Clusters > WebSphere Application Server Cluster > 


WFS_Cluster > Cluster Members and click the “Details” button 


OH HIAANIHAARYW 


. Click the “New” button 
. Enter the Member name for example TranslatorServer3 


Under Select node choose the name of the newly added node and press 
“Add Member.” Follow step 4 and 5 if needing additional cluster members. Press 
“Next” 


. Review the details and press the “Finish” button. 


Save the changes and click “OK” 


. Navigate to Servers > Server Types > WebSphere Application Servers 


Select the checkbox beside the newly added cluster member(s) and press the “Start” 
button. 


. Verify the new cluster member is working correctly by navigating to the translator 


toolbelt URL. For example: 
http://<serverName>:8088/translator/Translate? Action=toolbelt 


**Note: The port will change depending on the number of cluster members. The first 
member will be port 8085 and each additional member will increment by one (8086, 
8087, and 8088). 


Troubleshooting 


The Create button on the Web Server Plug-in Configuration Tool 
does not work 


This could indicate that you are experiencing a defect within the Configuration Tool that 
is resolved with APAR PM46369: Create button unresponsive in WAS v8 Plugin 
Configuration Tool of WebSphere Customization Toolbox.) http://www- 


01.ibm.com/support/docview.wss?uid=swg1PM46369 
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An upgrade is required to create the Web Server, as there is a defect with version 8.0 of 
the WebSphere Customization Toolbox. 


AddNode Task fails 

You may experience an issue where you run the addNode task but receive a failure at the 
command line. If this occurs and you can see the node "SECONDARYNodeName" still 
exists in the dmgr master configuration follow these steps to clean up: 


1. Make sure dmgr is running. 
2. Run cleanupNode.bat script from the Dmgr. Navigate to the bin directory of the Dmgr 
and run the task as the sample below. 


cleanupNode.bat <NodeName> <host> <host port> -trace 


C\Program Files\IBM\WebSphere\AppServer\profiles\Dmgr0 1 \bin>cleanupNode.bat 
SECONDARYNode01 DMGR.victoria.ibm.com 8879 -trace 


3. If this command runs fine with no errors then check the node location directory to 
make sure the "SECONDARYNode01" is no longer listed. 


4. After confirming the secondary node is removed, then stop dmgr and cleanup 
following directory : 
C\Program Files\I]BM\WebSphere\AppServer\profiles\Dmgr01\config\temp 


5. Clean up the C\Program 
Files\IBM\WebSphere\AppServer\profiles\AppServer\config\temp 


6. If the cleanupNode.bat command fails in the step 2, then create a PMR with the 


WebSphere Application Server team for assistance. Send them the new collector tool 
output from dmgr01 profile. 
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